home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / prog / dnalib59.arj / LIBMAN.DOC < prev    next >
Text File  |  1994-02-15  |  6KB  |  143 lines
  1. ┌─────────────────────────────────────────────────────────────────────┐
  2. │                                                                     │░░
  3. │                                                                     │░░
  4. │              DNALIB Library Manager for PowerBASIC 3c               │░░
  5. │                                                                     │░░
  6. │                  Copyright 1994 FreeBee SoftWare                    │░░
  7. │                                                                     │░░
  8. │                           Chris Foot                                │░░
  9. │                                                                     │░░
  10. └─────────────────────────────────────────────────────────────────────┘░░
  11.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  12.  
  13.  
  14.         LIBMAN is totally free of charge for you to use or abuse, as you
  15. see fit.  The source code will be released with DNALIB60 along with the
  16. additional routines I wrote for LIBMAN, you may contact me by
  17.  
  18.  1) leaveing me a message on BASNET(PowerBASIC) echo.
  19.  2) leaveing me a message at PowerBASIC tech support BBS.
  20.  3) or you can send me a FAX (403)452-5969
  21.                                             Chris
  22.  
  23. The first thing to do is make a working directory for LIBMAN, and copy
  24. the files LIBMAN.EXE and LIBMAN.CFG to the directory.
  25.  
  26. Then with a Text Editor edit the file LIBMAN.CFG
  27.  
  28. C:\PB3\         < directory where PBLIB.EXE resides
  29. C:\PB3\PBU\     < where you keep your PBU modules
  30. C:\PB3\OBJ\     < where you keep your OBJ modules
  31. C:\PB3\PBL\     < where you keep your PBL libraries
  32.  
  33. No comments are allowed in the file and each line MUST
  34. end with a backslash and carraige return!
  35.  
  36. Your Directory Tree should look something like this
  37.  
  38.         C:┐
  39.           ├PB3┐
  40.               ├BAS
  41.               ├LIBMAN < where LIBMAN.EXE & LIBMAN.CFG go
  42.               ├OBJ
  43.               ├PBL
  44.               ├PBU
  45.               └OTHER
  46.  
  47.  
  48.   I have done extensive testing of LIBMAN and this is what I
  49.   found.
  50.  
  51.    1) Run LIBMAN from DOSSHELL = NO PROBLEM.
  52.  
  53.    2) Run DNAWRITE from DOSSHELL then shell from DNAWRITE and run
  54.       LIBMAN = NO PROBLEM.
  55.         
  56.    3) Run PB IDE from DOSSHELL then shell from PB IDE and run
  57.       LIBMAN = works but does strange things.
  58.  
  59.    4) Run PB IDE and load LIBMAN.BAS compile and run LIBMAN from
  60.       PB IDE = works but does strange things.
  61.  
  62.    5) I strongly recommend running LIBMAN from the Command Prompt
  63.       and from it's own directory!!
  64.  
  65.   I have built, deleted, added, printed, extracted, transfered, 
  66.   etc at least 100 PBL's with consistent results.  I have also 
  67.   found a problem with PBLIB :(
  68.   If a PBU or OBJ is deleted and then for instance you modify
  69.   your code and make a new unit or object using the same name,
  70.   and then add it to your PowerBASIC library, take a look at
  71.   the map file or [B]rowse from LIBMAN and you will find you
  72.   got the old one back as well as the new one :(  This is also
  73.   the reason for the [K]ill and [E]rase options, it is easier
  74.   to E[x]tract all the modules to LIBMANs directory [K]ill the
  75.   old PBL and rebuild a new library of the same name, then
  76.   [E]rase LIBMANs directory so you dont get all tangled up :)
  77.  
  78.  
  79.     MENU OPTIONS    ACTIONS
  80.     ~~~~~~~~~~~~    ~~~~~~~
  81.     [O]pen          Opens a PowerBASIC library file and
  82.                     redirects output to LIBINFO.TXT then
  83.                     reads all OBJ and PBU modules to an
  84.                     Array.
  85.  
  86.     [C]reate        Displays an Edit window for inputting
  87.                     a Name for New library.
  88.  
  89.     [L]ist          Displays a list of OBJ and PBU modules
  90.                     in Map file order, for the currently
  91.                     selected PowerBASIC library.
  92.  
  93.     [B]rowse        Displays the PBLIB generated file
  94.                     LIBINFO.TXT in scrolling window.
  95.  
  96.     [A]dd           Displays a choice of module locations 
  97.  
  98.                     1) LIBMANs directory where extracted
  99.                        modules will be found.
  100.  
  101.                     2) OBJ directory, defined in LIBMAN.CFG
  102.  
  103.                     3) PBU directory, defined in LIBMAN.CFG
  104.  
  105.                     4) Selectable directory.
  106.  
  107.                     If a choice is made, a Taggable file
  108.                     list is displayed (files have to be
  109.                     tagged for addition). LIBMAN then builds
  110.                     a COMMAND.FIL from your choices and 
  111.                     SHELLs to PBLIB to do the work.
  112.  
  113.     [D]elete        A taggable file list is displayed, of
  114.                     the modules listed in the map file,
  115.                     (files have to be tagged for addition).
  116.                     LIBMAN then builds a COMMAND.FIL from 
  117.                     your choices and SHELLs to PBLIB to 
  118.                     do the work.
  119.  
  120.     E[x]tract       A taggable file list is displayed, of
  121.                     the modules listed in the map file,
  122.                     (files have to be tagged for addition).
  123.                     LIBMAN then builds a COMMAND.FIL from 
  124.                     your choices and SHELLs to PBLIB to 
  125.                     do the work.
  126.  
  127.     [P]rint         Sends the contents of LIBINFO.TXT to
  128.                     the printer.
  129.  
  130.     [K]ill          Displays a listing of up to 100 PBL's
  131.                     for selection for deletion from DISK!
  132.  
  133.     [E]rase         Deletes ALL OBJ and PBU modules from
  134.                     LIBMANs directory, confirmation is
  135.                     asked first though :)
  136.  
  137.     [Q]uit          Quits Library Manager and cleans up
  138.                     working directory, deletes ALL OBJ 
  139.                     and PBU modules from LIBMANs directory,
  140.                     confirmation is asked first though :)
  141.  
  142.  
  143.